*************************************************************
*                                                           *
*           P G E (for Panther Games Enhancement)           *
*                                                           *
* by Mark "MarkShot" Kratzer on 07/03/10 (revised 01/18/11) *
*                                                           *
*************************************************************

INTRODUCTION

This utilty provides hot spot map handling for HTTR/COTA/BFTB.  This means
that you that you can save map locations and zoom levels and recover them
with a single key stroke.  This will allow you to hop around maps of complex
scenarios very rapidly.

Additionally as an option, this utility will make HTTR's function key handling
consistent with COTA/BFTB.

USAGE - RUNNING PGE

The ZIP contains the source code, an AutoHotKey script.  If you want to
download and install AutoHotKey, then you can run the script as it stands.  Or
you can even further modify PGE.AHK yourself to further customize it.  See:

www.autohotkey.com

Otherwise, you can simply run the PGE.EXE while you are playing one of the
games.  PGE is not a mod or patch, and will not alter your games in any
way.  (It behaves more like a programmable joystick program.)  To exit PGE,
simply right click on the big green H in the System Tray and select exit.

USAGE - Hot Spots

Set a hot spot:  Use the Strat Map (upper left hand corner) to position the
map (preferably zoomed in).  With the left mouse button down, press F1-F12
where you want to save this hot spot.  You will hear a single BEEP
confirmation.

Set a zoom level:  With the left mouse button down, press 1-6 (1 = max zoom in).
The zoom level will be saved for whatever hot spot (F key) which you either
set or retrieved most recently.  So, you can set/reset the zoom level whenever
you want.  You will hear a double BEEP confirmation.

The default zoom level is set for 1.  You can set/reset the default zoom
level at any time.  With the right mouse button down, press 1-6
(1 = max zoom in).  This will reset all zoom levels to whatever you choose.
Meaning it will override and individual hot spot zoom levels which you have
already set.  You will hear a triple BEEP confirmation.

To retrieve a hot spot, with the right mouse button down, press F1-F12 corresponding
to your previously saved hot spot.

You can nudge (gradually move) a hot spot after it has been set.  With left
mouse button down, press the respective arrow key.  Nudging applies to whatever
hot spot was last set or accessed.

USAGE - INI

Hot spots are written to the PGE.INI file upon exit.  When you launch PGE, it
will ask if you want to load previous values from the INI file.  In this way,
you can carry hot spots across multiple gaming sessions.  The INI file will be
created the very first time you run PGE.  If you delete the INI file, PGE will
recreate it.

USAGE - HTTR Consistency Option

The behavior of the function keys were changed after HTTR.  If you are actively
playing all three games, this could be quite an annoyance.  This utility can
make HTTR's keys compatible with COTA/BFTB.

You must start PGE.EXE with the following switch:  HTTR+.  Like:

C> PGE.EXE HTTR+

The following adjustments were made:

(1) Reverse mouse wheel handling
(2) Swap keys F1<->F4, F2<->F3, F7->F10
(3) Kill redundant keys F8, F9, F10, F11, F12
(4) Overload F5(F5|F6), F6(F7|F8|F9)

WARRANTY, LIABILITY, & INTELLECTUAL PROPERTY

PGE is provided "as is".  The author assumes no responsibility for support and
maintenance.  Furthermore, if PGE should fail to behave as you expect, the
author assumes no liability.

You may redistribute and use PGE freely.  You have been provided with the source
code.  If you should alter PGE and redistribute it, please be so kind as to
acknowledge the author's original work.  Thank you.

Mark Kratzer - 07/03/10

RELEASE HISTORY

v01 - 07/03/10 - Initial release.

v02 - 07/04/10 - Fixed a problem with partial window names being matched.

v03 - 01/18/11 - Added persistence (INI) and nudging of hot spots.